マルペイDocs

楽天ペイ（オンライン決済）V2とは

楽天ペイ（オンライン決済）V2とは楽天会員を対象としたオンライン決済サービスです。 楽天IDに登録したクレジットカードや、楽天ポイントの残高を利用して、商品等の代金を支払うことができます。本ドキュメントでは「楽天ペイ（オンライン決済）V2」について楽天ペイV2と表記します。

処理フロー説明

1. 購入（お客様→加盟店様）
2. 購入情報通知（加盟店様→当サービス）
3. 決済依頼通知（当サービス→楽天）
4. 楽天チャージID発行（楽天→当サービス）
5. 楽天ペイ決済画面URL返却（当サービス→加盟店様）
6. 楽天ペイ決済画面誘導（加盟店様→お客様）
7. 決済（お客様→楽天）
8. 決済完了通知（楽天→当サービス）
9. 決済完了通知（当サービス→加盟店様）
10. サービス提供
11. 入金（楽天→加盟店様）

取引状態

取引状態		説明
未決済	UNPROCESSED	決済が完了していない状態（お客様がご注文途中に離脱が主な原因）
要求成功	REQSUCCESS	決済準備が整った状態（まだお客様は支払っていません）
認証処理中	AUTHPROCESS	楽天ペイでの支払い中の状態
仮売上	AUTH	決済が正常に完了し、ご利用枠を確保した状態 （お客様への請求は発生しません）
即時売上	CAPTURE	売上が確定した状態
実売上	SALES	仮売上後に売上が確定した状態
キャンセル	CANCEL	仮売上の取引がキャンセルされた状態
返品	RETURN	実売上／即時売上の取引がキャンセルされた状態
決済失敗	PAYFAIL	お客様のクレジットカード状態や、システムトラブル等の何らかの原因で決済、利用承諾に失敗した状態
期限切れ	EXPIRED	要求成功および認証処理中の状態を一定時間経過した状態

取引状態遷移

各操作を行った際の取引状態の遷移です。
「－」は、該当する結果、もしくは操作がないことを表しています。

操作	操作結果	操作前の状態	操作後の状態
取引登録	－	－	未決済
決済実行	成功	未決済	要求成功
	失敗		未決済
支払手続き開始	成功	要求成功	認証処理中
	失敗		要求成功
お客様が楽天ペイでお支払い	成功	認証処理中	仮売上／即時売上
	失敗		決済失敗
実売上	成功	仮売上	実売上
	失敗		仮売上
キャンセル	成功	仮売上／実売上／即時売上	キャンセル／返品
	失敗		仮売上／実売上／即時売上
金額変更	成功	仮売上／実売上／即時売上	仮売上／実売上／即時売上
	失敗
仮売上有効期限延長 （同額の金額変更）	－	仮売上	仮売上
支払操作が未完了で期限切れ	－	要求成功／認証処理中	期限切れ

取引状態における可能操作

取引状態	取引登録	決済実行	支払手続き開始	仮売上	実売上	キャンセル	金額変更	仮売上有効期限延長
未決済	-	〇	-	-	-	-	-	-
要求成功	-	-	〇	-	-	-	-	-
認証処理中	-	-	-	〇	-	-	-	-
仮売上	-	-	-	-	〇	〇	〇	〇
即時売上	-	-	-	-	-	〇	〇	-
実売上	-	-	-	-	-	〇	〇	-
キャンセル	-	-	-	-	-	-	-	-
返品	-	-	-	-	-	-	-	-
決済失敗	-	-	-	-	-	-	-	-
期限切れ	-	-	-	-	-	-	-	-

接続方式別の対応状況

接続方式	対応状況
プロトコルタイプ	○
モジュールタイプ	○
リンクタイプPlus	○

注意事項

内容	説明
利用可能な決済金額	100～9,999,999円 利用金額+税送料の合計金額になります。 100円未満の決済が必要な場合は事前に楽天へお問い合わせください。
仮売上有効期限延長	同額で金額変更のAPIを実行することで、仮売上有効期限を延長することができます。 再オーソリを行なうため、お客様の限度額を超えた場合は失敗する可能性があります。
仮売上有効期限延長可能回数	一つの取引に対し、成功・失敗合わせて15回までです。 可能回数を超えた場合は「RP1000006」エラーが返却されます。
金額変更	金額変更の回数に制限はありません。
決済リトライ機能	決済実行にて決済リトライ可能回数を指定すると、お客様の選択したクレジットカードに不備があり決済に失敗した際に、再度クレジットカードを選び直し決済していただくことが可能です。 決済に成功するか、指定した回数分失敗すると加盟店様へ結果が返却されます。 楽天の判定により、指定した回数未満で結果が返却されることもあります。
期限切れ	状態が要求成功（REQSUCESS）または認証処理中（AUTHPROCESS）のまま処理期限が過ぎた取引については、毎日夜間に取引状態を期限切れ（EXPIRED）に更新します。
メール	以下の処理タイミングで楽天からお客様にメールが送信されます。 ・決済成功時 ・金額変更時（同額は含まない） ・キャンセル時
在庫キャンセル	決済後に在庫の引き当てが出来なかった場合は、速やかにキャンセルを実施してください。 （ユーザ様が期間限定ポイントを使用していた場合、トラブルに発展する可能性があるため。）
楽天表記審査・システムチェックについて	サービスリリース前に楽天レギュレーションの対応状況を確認する表記審査・システムチェックがございます。 実装前に楽天レギュレーションをご確認ください。詳細は楽天ペイ営業担当へお問い合わせください。
支払いボタンについて	楽天ペイ選択後、楽天ログイン画面へ遷移させる遷移元画面に設置いただくボタンは楽天指定のソースである必要があります。 実装前に楽天レギュレーションをご確認ください。 詳細は楽天ペイ営業担当へお問い合わせください。
楽天ペイについて	「楽天ペイ（オンライン決済）V2」は従来の「楽天ペイ」とは別サービスになります。 本仕様書は「楽天ペイ（オンライン決済）V2」になります。 「楽天ペイ」をご利用の加盟店様は別ドキュメントになりますのでご契約をご確認ください。
楽天ペイ決済画面猶予期間について	決済実行後、30分以内にお客様が楽天ペイ決済画面にログインする必要があります。 また、ログイン後、60分以内に決済を完了する必要があります。
3Dセキュアについて	注文/申込時に3Dセキュア認証を行っていたとしても、お客様が支払画面を経由しないオーソリ取得については3Dセキュアが無効となります。 （例：購入後の金額変更、再オーソリ処理、汎用決済の注文） ただし、例外として実売上状態の注文に対する減額の金額変更処理については、オーソリの再取得を行っていないため3Dセキュアは有効のままです。
楽天ポイント/キャッシュ分の返還について	キャンセル可能期限を過ぎた場合、楽天ポイント/キャッシュは返還されません(※2)。 お客様とのトラブル防止のため、各処理期限までに実売上処理、またはキャンセル/返品を実施してください。 既定の期限を超過し実売上処理、またはキャンセル/返品をともに行えなくなった場合、楽天ポイント/キャッシュについては加盟店様にてお客様へ直接返金を実施してください。

各処理期限

取引状態	実売上	キャンセル	金額変更	仮売上有効期限延長
仮売上	最後の仮売上日（※1）から30日後まで かつ初回の仮売上日から365日後（※2）まで	初回の仮売上日から365日後（※2）まで	初回の仮売上日から365日後（※2）まで かつ最後の仮売上日（※1）から30日後まで	初回の仮売上日から365日後（※2）まで かつ最後の仮売上日（※1）から160日後まで
実売上／即時売上	-	初回の仮売上日から365日後（※2）まで かつ実売上／即時売上日から30日後まで	初回の仮売上日から365日後（※2）まで かつ実売上日／即時売上日から30日後まで	-

※1 「最後の仮売上日」とは、仮売上、金額変更、仮売上有効期限延長の最終実施日を指します。
※2 対象取引の更新が無い場合は原則180日でデータが削除され、以降は処理ができなくなります。
  金額変更、仮売上有効期限延長により取引を更新した場合の最大日数が365日後となりますのでご注意ください。

ロゴについて

必ずロゴマーク利用ガイドラインをご確認の上ご利用ください。

ロゴ

ロゴはデザイン、カラーを変更せず十分な余白を用意し、そのままの状態で利用ください。

【大】300×88	https://checkout.rakuten.co.jp/rpay/logo/s_sb_30088.jpg
【中】200×59	https://checkout.rakuten.co.jp/rpay/logo/s_sb_20059.jpg
【小】100×30	https://checkout.rakuten.co.jp/rpay/logo/s_sb_10030.jpg
【大】140×127	https://checkout.rakuten.co.jp/rpay/logo/w_wb_140127.jpg
【中】100×91	https://checkout.rakuten.co.jp/rpay/logo/w_wb_10091.jpg
【小】60×55	https://checkout.rakuten.co.jp/rpay/logo/w_wb_6055.jpg

決済ボタン

楽天ペイの決済ボタンを動的に生成する場合、決済フローの楽天ペイ注文ボタン生成についてをご利用いただくようお願いします。